home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2004 #9 / Amiga Plus CD - 2004 - No. 09.iso / amigaplus / tools / amigaos4_only / pngtool / pngtool.doc < prev    next >
Text File  |  2004-08-03  |  4KB  |  119 lines
  1.                         PNGTool
  2.         © 2002-2004 by Stephan Rupprecht
  3.                 All rights reserved.
  4.  
  5.  
  6. COPYRIGHT AND DISCLAIMER
  7.  PNGTool is copyrighted 2002-2004 by Stephan Rupprecht. All rights
  8.  reserved. This program is freeware, so no financial donations
  9.  required. Redistribution allowed if the package is left unchanged.
  10.  The author is not responsible for any damage caused by the use
  11.  or misuse of this documentation and/or the program(s) it describes.
  12.  
  13.  PNG support provided by the libpng link library by the PNG Development
  14.  Group, and the zlib link libary by Jean-loup Gailly and Mark Adler.
  15.  
  16.  
  17. REQUIREMENTS
  18.  - Any Amiga® (compatible) computer with at least OS3 and '020+ cpu.
  19.  - picture.datatype v43 or better (to convert HAM images you need
  20.    at least v44!).
  21.  - asyncio.library v39.
  22.  - A PPC version for computers with WarpUP is also included (requires
  23.    asyncio.library v40).
  24.  
  25.  
  26. DESCRIPTION
  27.  PNGTool is a simple program that can convert any image that is
  28.  recognized by datatypes to PNG.
  29.  
  30.  
  31. INSTALLATION
  32.  Simply copy PNGTool to where-ever-you-want :)
  33.  
  34.  
  35. USAGE
  36.  You can start PNGTool only from shell, since it's a DOS command
  37.  (except for the possibility to start it from Workbench through
  38.  the menu item 'Execute Command...'). The following options are
  39.  provided:
  40.  
  41.  FROM/M/A,TO/A,ALL/S,C=COMPRESSIONLEVEL/N/K,I=INTERLACED/S,S=SCALE/N/K,
  42.  T=TRANSPARENT/N/K,A=ALPHAMASK/K
  43.  
  44.  FROM/M/A: specifies the image(s) to convert, patterns will be accepted.
  45.  
  46.  TO/A: name of the new image(s) including the destination path. The specified
  47.   filename is not necessarily just a simple identifier representing exactly 
  48.   one disk object. Instead, it is a template which may contain variables/
  49.   placeholders which will be replaced by their actual values. Placeholders
  50.   recognized are:
  51.   
  52.    %n   name of the source file without suffix. You can shorten the
  53.         filename by providing the maximum number of characters allowed
  54.         between % and n (eg. %5n).
  55.    %nu  Each time an image is converted an internal counter will be
  56.        increased. %nu holds the current value of this counter.
  57.    %w   width of the image.
  58.    %h   its height.
  59.    %d   and the depth
  60.    %sz  shortcut for %wx%hx%d.
  61.  
  62.   NOTE: Source and destination MUST NOT be the same file !
  63.  
  64.  ALL/S: convert subdirectories, too. A new directory in the destination
  65.   drawer _won't_ be created!
  66.  
  67.  C=COMPRESSIONLEVEL/N/K: 0 means no compression, 1 a very little and
  68.   9 best compression at expense of speed (default is 5).
  69.   
  70.  I=INTERLACED/S: create an interlaced image.
  71.  
  72.  S=SCALE/N/K: this option allows you to scale the image down by the
  73.   given denominator. Eg. a value of 2 creates an image that is half
  74.   the size of the original one. This option requires picture.datatype
  75.   v45!
  76.   
  77.  T=TRANSPARENT/N/K: sets the transparent color for the image (if
  78.   palette mapped). A value of -1 disables transparency.
  79.   
  80.  A=ALPHAMASK/K: Name of an image file containing the alpha information
  81.   for the PNG image to produce. The alpha mask needs to have the
  82.   same size as the FROM image, its depth must either be 2 (b/w) or
  83.   8 (256 greyscale). When the FROM file(s) has a different size or
  84.   less than 15 bit, the alpha information is ignored.
  85.  
  86.  
  87. HISTORY
  88.  1.0  first public release
  89.  1.1  requires asyncio.library v40, now. This increases the speed
  90.       of both versions by 3% :) It also lessens the 68k load when
  91.       using the ppc version even though the ppc load has increased.
  92.       The ppc version now uses a more recent release of libpng
  93.       and zlib making the executable ~30kb smaller. added SCALE/N/K
  94.       option (requires pictdt v45) and TRANSPARENT/N/K. 
  95.  1.2  added A=ALPHAMASK/K option due to heavy demand (two users;).
  96.  1.3  Ooops! Handling of HAM images was broken <Philippe Bovier>.
  97.  1.4  linked with latest release of libpng and zlib. 
  98.  1.5  AmigaOS4 release (asyncio.library for OS4 is part of this archive).
  99.  
  100. FUTURE
  101.  bugfixes ;)
  102.  your suggestions
  103.  
  104.  
  105. AUTHOR
  106.  Please send bug reports and ideas to
  107.  
  108.      Stephan Rupprecht
  109.      Apfeldweg 1
  110.      D44359 Dortmund
  111.      Germany
  112.  
  113.  Send emails to
  114.  
  115.      info@stephan-rupprecht.de
  116.      
  117.  WWW
  118.          http://stephan-rupprecht.de
  119.